Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

통계 API 연동 구현

개요

통계 화면(StatsView)에 API 연동을 구현한 PR입니다. 기존 이진 상태(진행중/종료) 기반 API 호출을 단일 통합 메서드로 리팩토링하고, 사용자별 완료 횟수 및 스탬프 색상을 표시하는 새로운 데이터 구조를 도입했습니다. (관련 issue: #197)

아키텍처 변경사항

Dependency/Client 간소화

• StatsClient의 API 메서드를 fetchOngoingStats(String), fetchCompletedStats(String) 두 개에서 단일 메서드 fetchStats(String, Bool)로 통합
  • 두 번째 Bool 파라미터가 진행중(true)/종료(false) 상태를 제어
• 새로운 StatsClient+Live.swift에서 실제 네트워크 구현 제공
  • networkClient를 통해 StatsEndpoint.fetchStats 호출
  • response를 StatsResponseDTO로 디코딩 후 toEntity(isInProgress:) 메서드로 도메인 entity로 변환

State & Action Flow 업데이트

• StatsReducer.State에서 hasItems computed property 제거
  • StatsView에서 !store.items.isEmpty 직접 체크로 변경
• StatsReducer+Impl.swift에서 단일 fetchStats 호출로 통합
  • 기존 두 개의 별도 호출 대신 isOngoing 플래그 기반 단일 호출로 간소화

Entity 구조 변경

• Stats.StatsItem에서 완료 횟수 기반 시스템을 Stamp 기반 시스템으로 전환
  • 이전: myCompletedCount, partnerCompletedCount (Int)
  • 현재: myStamp, partnerStamp (Stamp 구조체)
    • 각 Stamp는 completedCount: Int와 stampColors: [StampColor] 포함
• 새로운 Stats.StampColor enum으로 스탬프 색상 표현

UI 컴포넌트 업데이트

• StatsCardItem에 stampIcon: TXVector.Icon 추가 (목표별 아이콘)
• StatsCardItem.CompletionInfo에 stampColors: [StampColor] 추가
• StatsCardView에서 색상 렌더링 로직 변경
  • 무작위 색상 배열 대신 완료 정보별 stampColors 사용

네트워크 & DTO

• 새 endpoint: StatsEndpoint.fetchStats(selectedDate: String, status: String)
• 새 DTO: StatsResponseDTO (response decoding용)
  • 변환 메서드 toEntity(isInProgress:) 구현으로 도메인 entity 생성
• Endpoint.FeatureTag에 stats case 추가

사용자 영향

• UI: "스탐프 통계" 화면에서 진행중/종료 탭별로 습관 카드 표시 (각 카드는 사용자별 완료 횟수 + 스탬프 색상 표시)
• Empty state 처리 개선으로 깜빡임 제거

테스트 커버리지

• 기존 testValue/previewValue를 새로운 fetchStats 시그니처로 업데이트
• StatsApp 예제에서 .previewValue 사용으로 변경

Walkthrough

통계 API 연동을 위한 네트워크 엔드포인트, 데이터 전송 객체(DTO), 클라이언트 API를 추가하고, 기존 클라이언트 인터페이스를 통합하며, 스탬프 시스템으로 엔티티 모델을 업데이트하고, UI 컴포넌트와 리듀서 로직을 연결했습니다.

Changes

Sequence Diagram

sequenceDiagram
    actor User
    participant StatsView
    participant StatsReducer as StatsReducer<br/>(Impl)
    participant StatsClient
    participant NetworkClient
    participant API as Stats API
    participant StatsResponseDTO
    participant Stats as Stats Entity

    User->>StatsView: 월 선택 또는 뷰 진입
    StatsView->>StatsReducer: fetchStats 액션 전송
    StatsReducer->>StatsClient: fetchStats(month, isInProgress)
    StatsClient->>NetworkClient: 요청 생성<br/>(selectedDate, status)
    NetworkClient->>API: GET /api/v1/stats<br/>(쿼리 파라미터 포함)
    API-->>NetworkClient: StatsResponseDTO 응답
    NetworkClient-->>StatsClient: 디코딩된 DTO 반환
    StatsClient->>StatsResponseDTO: toEntity(isInProgress)
    StatsResponseDTO->>Stats: 도메인 엔티티 변환<br/>(스탬프 데이터 매핑)
    Stats-->>StatsResponseDTO: Stats 객체 반환
    StatsResponseDTO-->>StatsClient: Stats 반환
    StatsClient-->>StatsReducer: Stats 전달
    StatsReducer->>StatsReducer: 상태 업데이트<br/>(items, stampIcon, stampColors 매핑)
    StatsReducer-->>StatsView: 업데이트된 상태
    StatsView->>StatsView: StatsCardView 렌더링<br/>(stampIcon, stampColors 표시)
    StatsView-->>User: 통계 카드 화면 표시

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

• X
• Mastodon
• Reddit
• LinkedIn

Summary regeneration triggered.